home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / games / nhak_src.zip / README < prev    next >
Text File  |  1993-03-16  |  7KB  |  143 lines
  1.  
  2.         NetHack 3.0 -- General information
  3.  
  4. NetHack 3.0 is a new generation of the dungeon exploration game NetHack.
  5. It is a distant descendent of Hack, and a direct descendent of NetHack 2.3.
  6. It is the product of a year-long, very intensive, international team
  7. effort.  Many parts of 2.3 were rewritten for NetHack 3.0, and many new
  8. features were added.  Judged by size alone, with all options enabled,
  9. NetHack 3.0 is twice as big as 2.3.
  10.  
  11. While aiming at retaining the general atmosphere of NetHack 2.3, we sought
  12. to open up new directions of development for the game.  Alignment, both for
  13. player characters and for monsters, was introduced.  Player character
  14. attributes were added and integrated into the game.  Special compiled
  15. levels were added, and these open up endless future possibilities.  An
  16. endgame was written, for a climactic ending.  The code for monsters and
  17. objects was massively rewritten, and many new creatures and items were
  18. added.  The self-polymorph code was debugged and greatly enriched.  Shops,
  19. too, were enhanced.  There are now doors in doorways and chests that may
  20. contain valuables, both of which may be closed or locked.  New commands to
  21. open or kick doors and force locks on chests were added.  You can also use
  22. kicking as an attack mode, and you can kick objects around if it pleases
  23. you.  You will discover the rest for yourselves...
  24.  
  25. To compensate for the massive additions, we rewrote the code around some
  26. new map fields for an increase in speed up to, if not beyond, that of 2.3.
  27. The code is now organized, and nearly lint-free.
  28.  
  29. We dedicate the game to the many unknown hackers, both past and future, who
  30. contribute so much to the game.
  31.  
  32.             - - - - - - - - - - -
  33.  
  34. Please read items (1), (2) and (3) BEFORE doing anything with your new code.
  35.  
  36. 1.  Unpack the code in a dedicated new directory.  We will refer to that
  37.     directory as the 'Top' directory.  It makes no difference what you
  38.     call it.
  39.  
  40. 2.  If there is no flaw in the packaging, SEVEN sub-directories will be
  41.     automatically created, and files will be deposited in them: 
  42.  
  43.     a.  A 'src' directory, which will contain general *.c files.
  44.     b.  An 'include' directory, which will contain general *.h files.
  45.     c.  An 'auxil' directory, which will contain a variety of data files.
  46.     d.  An 'amiga' directory, which will contain the Amiga-specific files.
  47.     e.  An 'others' directory, which will contain MSDOS and TOS files.
  48.     f.  A 'vms' directory, which will contain VMS files.
  49.     g.  A 'mac' directory, which will contain Macintosh files.
  50.  
  51.     The names of these directories should not be changed, unless you are
  52.     ready to go through the makefiles and the makedefs program and change
  53.     all the directory references in them.
  54.  
  55. 3.  Having unpacked, you should have a file called 'Files' in your Top
  56.     directory.  This file contains the list of all the files you now SHOULD 
  57.     have in each directory.  Please check the files in each directory 
  58.     against this list to make sure that you have a complete set.
  59.  
  60. 4.  Before you do anything else, please read carefully the file called
  61.     'license' in the auxil subdirectory.  It is expected that you comply
  62.     with the terms of that license, and we are very serious about it.  In
  63.     particular, you are prohibited by the terms of the license from using
  64.     NetHack 3.0 for gainful purposes.   
  65.  
  66. 5.  If everything is in order, you can now turn to trying to get the program
  67.     to compile and run on your particular system.  It is worth mentioning
  68.     that the default configuration is Ultrix (simply because the code was
  69.     housed on such a system).  It is also worth mentioning here that NetHack
  70.     3.0 is a huge program by comparison with 2.3.  If you intend to run it
  71.     on a small machine, you'll have to make hard choices among the options
  72.     available in config.h.
  73.  
  74.     The files Install.* were written to guide you in configuring the program
  75.     for your operating system.  Reading them, and the man page, should answer
  76.     most of your questions.
  77.  
  78.     At the time of this release, NetHack 3.0 is known to run on:
  79.  
  80.         AT&T 3B1 running System V (3.51)
  81.         AT&T 3B2/600 & 3B2/622 running System V R3.2.1
  82.         AT&T 3B2/1000 Model 80 running System V R3.2.2
  83.         AT&T 3B4000 running System V
  84.         Bull DPX/2 200 running System V R3.1
  85.         Bull XPS100 running System V R2.2 or R3.1
  86.         Data General AViiON systems running DG/UX
  87.         DEC vaxen running Ultrix and BSD
  88.         Decstation 5400 running Ultrix 3.1
  89.         Encore Multimax running UMAX 4.2
  90.         Gould NP1 running UTX 3/2
  91.         H-P 9000s300 running HP-UX
  92.         IBM PC/RT running AIX
  93.         Mips M2000 running RiscOS 4.1
  94.         Pyramid 9820x running OSx 4.4c
  95.         SGI Iris running IRIX
  96.         Stride 460 running UniStride 2.1
  97.         Sun-3s and -4s running SunOS 3.x and 4.0.x
  98.         Valid Logic Systems SCALD-System
  99.         286 box running Microport SysV/AT (not extensively tested)
  100.  
  101.         Apple Macintosh running MacOS
  102.         Atari 1040ST running TOS
  103.         Commodore Amiga running AmigaDOS 1.3 (WorkBench 1.3,
  104.                 KickStart 1.2 or 1.3) with Lattice or Manx/Aztec C
  105.         DEC vaxen running VMS
  106.         IBM PC compatibles running MS-DOS with MicroSoft C or Turbo C
  107.         IBM PS/2 and AT compatibles running OS/2 with MicroSoft C
  108.  
  109.             - - - - - - - - - - -
  110.  
  111. If you have problems building the game, or you find bugs in it, the 
  112. development team may be reached as
  113.  
  114.             nethack-bugs@linc.cis.upenn.edu.  
  115.  
  116. Please be sure to include your machine type, OS, and patchlevel.
  117.  
  118. Patches especially should be directed to this address.  If you've changed 
  119. something to get NetHack to run on your system, it's likely that others have
  120. done it by making slightly different modifications.  By routing your patches
  121. through the development team, we should be able to avoid making everyone else
  122. choose among variant patches claiming to do the same thing, to keep most of
  123. the copies of 3.0 synchronized by means of official patches, and to maintain
  124. the painfully-created file organization.  (Remember the mess when everybody
  125. just posted their own patches to 2.3?  There were no archived bug-fixes to
  126. give people who got 2.3 after its initial release, so the same bugs kept being
  127. discovered by new batches of people.  Please cooperate to keep this from
  128. happening to 3.0.)
  129.  
  130. It is inevitable that we will reject some proposed additions of new features
  131. either because they do not fit our conception of the game, or because they 
  132. require more code than we consider they're worth.  If we reject your feature,
  133. you are free, of course, to post the patches to the net yourself and let the
  134. marketplace decide its worth.
  135.  
  136. All of this amounts to the following:  If you decide to apply a free-lanced
  137. patch to your 3.0 code, you are on your own.  In our own patches, including
  138. those which will update to 3.1, we will assume that your code is synchronized
  139. with ours.
  140.  
  141.           -- Good luck, and happy Hacking --
  142.  
  143.